Le générateur de documentation de code source doxygen est sorti en version 1.5.0 le 17 octobre dernier.
C'est une bonne occasion de présenter très brièvement ce qui devrait faire partie de toute boîte à outils d'un bon programmeur.
Doxygen est donc un logiciel permettant de documenter facilement son code par un système de commentaire-tags. Les utilisateurs de
javadoc, par exemple, se retrouveront facilement dans la manière de procéder, cependant on dénombre près de 170 tags par défaut pour doxygen auquel s'ajoute un système permettant d'ajouter ses propres tags afin de répondre aux besoins du projet.
En plus de la documentation des sources (prototype des fonctions, des classes), on peut obtenir les informations suivantes :
- Liste des fichiers inclus;
- Documentation des structures de données;
- Hiérarchie des classes;
- Différents types de graphiques : diagrammes de classe, de collaboration, d'appels, d'inclusion, etc;
- Un index de tous les identifiants;
- Des fichiers sources annotés.
La documentation produite est généralement au format HTML à cause de sa facilité d'emploi, cependant il est possible d'obtenir des fichiers LATEX, PostScript, PDF, XML, man et même Word et CHM.
Doxygen a été écrit en grande partie par Dimitri van Heesch qui trouvait, à l'époque, la documentation générée pour Qt très jolie et
doc++ trop limité pour réaliser un travail similaire.
Aujourd'hui doxygen supporte C/C++, Java, (Corba et Microsoft) Java, Python, IDL, C#, Objective-C et en partie D et PHP.
Doxygen est distribué sous
licence GPL, un binaire est disponible pour Windows 95 à XP et pour Mac OS X mais toute bonne distribution doit le mettre à disposition (nécessite la libqt).
Le projet
Veni, Vidi, Libri a pour objectif de promouvoir les licences libres et de faciliter le passage d'oeuvres propriétaires - notamment logicielles - sous licence libre.
Travaillant jusqu'à peu sans grande publicité dans les soubassements de
Framasoft, nous sommes heureux de pouvoir aujourd'hui prendre notre envol grâce à l'aide de ce dernier. C'est la raison pour laquelle nous sommes fiers de vous présenter notre propre site à l'adresse suivante : http://venividilibri.org.
En contactant les développeurs pour leur proposer un passage au libre et en aidant ceux qui le souhaitaient, nous avions le sentiment de répondre à une attente. Ce site permettra plus largement de diffuser les connaissances utiles pour comprendre et utiliser les licences libres.
Basé sur un wiki, le site restera interactif et ouvert aux contributions. Ainsi, les informations utiles lors des différentes phases d'un passage au libre seront expliquées. De même, un maximum de licences libres,
open source et
open content, pourront être détaillées ; pour toutes informations ou précisions complémentaires, n'hésitez pas à nous contacter, sur le site ou directement à info @ venividilibri.org.
Depuis 4 ans, j'entretiens (avec un léger décalage) la traduction de la documentation de Postfix en français. Depuis ce soir, les nouveautés apparues avec la version 2.3 de Postfix sont intégrées.
Au programme, le support des applications Milter (mail filter), le support
IPv6, l'intégration de
TLS et
SASL jusque là disponibles sous forme de patch et de nombreuses améliorations concernant la sécurité et les performances.
Cette documentation contient l'équivalent PDF de 350 pages organisée en quelques documents de base convenant à la plupart des utilisateurs et de nombreux éclaircissement sur des sujets précis tels l'utilisation d'un annuaire
LDAP, du chiffrement TLS, etc.
Cette traduction n'est probablement pas parfaite, alors n'hésitez pas à m'écrire pour les corrections d'erreur ou meilleures traductions que vous trouverez.
Postfix est un serveur de messagerie - un agent de transfert de messages.
Souvent présentés comme absents de l'Internet gouvernemental, les logiciels libres font, tout du moins ces dernières années, beaucoup parler d'eux. Cette étude a pour objectif de clarifier les choses et de présenter l'état des lieux sur l'utilisation des logiciels libres au sein de l'Internet gouvernemental québécois et canadien.
La rédaction de cette dernière a nécessité la réalisation d'une seconde étude. En effet, afin d'appuyer certains chiffres trouvés sur l'utilisation des serveurs de messagerie, il nous fallait avoir un référentiel de comparaison. Nous avons donc réalisé une étude sur les logiciels serveurs de messagerie présents sur l'Internet Mondial.
Pour finir, sachez que ces deux études sont sous licence libre GNU/FDL.
PlanFacile est un compilateur de documents, dans le sens où il génère des documents non formatés à partir d'un ensemble de concepts reliés entre eux sémantiquement.
PlanFacile peut se révéler utile lorsque l'on a du mal à réorganiser ses idées sur un rapport, où lorsque le document est rédigé par plusieurs personnes. Dans ce dernier cas, cela permet de conserver une certaine cohérence globale du texte.
NdM: l'archive tar.gz contient la documentation fournie uniquement sous forme de fichiers sources (*.plf). Ce sont des exemples que l'on peut compiler soi-même ou laisser le Makefile s'en charger.
Après la première publication de sa formation libre sur Linux embarqué en octobre 2004, la société azuréenne
Free Electrons publie un point sur les nombreuses améliorations apportées en 1 an à cette formation.
Cette formation est bien-sûr destinée à des sessions en entreprise (qui constituent sa source de financement), mais elle est également conçue pour être utilisée par toute personne souhaitant se former par elle-même.
Enfin, même si sa cible principale est le développement de systèmes embarqués, cette formation inclut de nombreuses ressources utiles aux développeurs et aux utilisateurs de GNU/Linux et autres systèmes d'exploitation libres: ligne de commande, noyau Linux et développement de pilotes, outils légers, audio, multimédia, outils de développement...
En fonction de la demande, certains de ces cours seront bientôt donnés gratuitement par leur auteur aux adhérents de Linux-Azur (à suivre sur le lien ci-dessous).
La troisième édition du ''Livret du Libre'' est disponible. Ce document se veut une introduction au Libre accessible aux non-informaticiens. Les thèmes abordés sont le partage des connaissances, le Libre, le copyleft, GNU, le Logiciel Libre, les autres formes d'expression libre, DMCA/EUCD, les brevets logiciels, TCPA ainsi que quelques pistes pour se libérer au quotidien.
L'objectif n'est pas de faire un livre de référence permettant de tout connaître sur tous les sujets, mais de faire un petit livret court, accessible, que l'on peut distribuer et faire lire à n'importe qui.
Le laboratoire Linux est une entité de l'École Supérieure d'Informatique SUPINFO formant les élèves aux technologies GNU/Linux.
L'intégralité de ses cours est disponible en ligne sur
son site, ainsi que beaucoup d'autres documentations ne faisant pas partie du cursus.
Pour fêter la nouvelle année, le site du laboratoire Linux fait peau neuve : les essentiels de cours et les articles sont désormais tous disponibles en HTML (
NdM : certains anciens articles ne sont en fait disponibles qu'en PDF semble-t-il).
De plus, plusieurs articles en préparation depuis quelques mois sont désormais disponibles : un sur Open-Exchange et sur la messagerie.
Open-Exchange est un outil de travail collaboratif permettant de partager entre différents utilisateurs des documents, un carnet d'adresse, un calendrier,
etc.
L'article sur la messagerie décrit pas à pas l'installation et la configuration de tous les éléments nécessaires pour mettre en place un serveur mail sous Linux : les serveurs Sendmail, Postfix, QMail, avec base de donnée MySQL/PostgreSQL et/ou annuaire OpenLDAP, mais aussi les services POP, IMAP, les anti-spams, les gestionnaires de mailing-listes, les anti-virus, et beaucoup d'autres choses.
Le site gtk-fr.org, considéré comme la meilleure ressource pour le développeur gtk+ préférant le français à l'anglais, a récemment pris un tournant radical : the wiki way (non ce n'est pas une barre chocolatée :).
Créé en juillet 2002 à l'initiative de Julien IBARZ, les administrateurs du site ont en effet pris la décision de transformer gtk-fr.org en Wiki, faute de temps pour s'en occuper (ils étaient 4), car celui-ci commençait à dépérir du fait de son manque de fraîcheur niveau contenu.
La communauté gtk est donc invitée à aller scribouiller quelques lignes de temps à autres sur le wiki, et en quelques temps celui-ci pourrait devenir une vrai ressource, à jour, et ainsi donc incontournable pour le développeur francophone gtk+.
Souvenez-vous : il y a quelques mois, Christian Casteyde, l'auteur du "YAGIL" ("Yet Another Guide d'Installation de Linux"), l'excellent guide d'installation Linux en FDL et de nombreuses autres documentations (comme le cours de C++), fermait son site en raison du risque que les brevets logiciels soient créés en Europe, et de l'adoption de la loi sur la confiance en l'économie numérique (LEN).
Le 1er novembre, il est revenu sur sa décision ! Et a mis en ligne une nouvelle version du YAGIL, la 2.6.1. C'est une très bonne nouvelle, étant donné la grande qualité de ses documentations qui surpassent beaucoup d'autres publications.
Écrit par Salvino A. Salvaggio, consultant expérimenté travaillant actuellement pour Quatar Telecom, il évoque sur 222 pages, l'histoire, les arguments pour et contre l'utilisation de logiciels libres en entreprise.
Ce rapport est très positif pour le logiciel libre. Il est par ailleurs très bien argumenté en chiffres et en faits.
De plus il recense de nombreuses migrations dans tous les secteurs économiques d'une solution propriétaire à une solution libre et analyse ses effets.
Le rapport est en accès gratuit toutefois il faut préalablement s'inscrire.
Le site francophone de la programmation Qt proposera prochainement un ouvrage d'initiation en français permettant aux débutants de se lancer avec Qt 3.
Ce livre, une initiation à la bibliothèque ne traitera que les points importants à connaître pour débuter. Déjà bien avancé, il sortira sans doute dans quelques semaines.
Il est destiné à combler l'absence d'ouvrages en français sur le sujet. En effet le dernier (Programmer avec Qt chez O'REILLY) daté de l'année 2000 traite de Qt 1.42.
Mise à jour : Le livre « Débuter avec Qt 3 », en français, annoncé il y a quelques semaines est maintenant disponible sur le site francophone de la programmation Qt prog.qt (et uniquement là).
Un administrateur système, Fabrice Clerc, connu pour son expertise netbios et samba (GLMF 44, 45, 46), avait rédigé sur le site de l'ABUL un article pour expliquer comment AOL gérait les mails et y avait joint la "Liste blanche pour mails AOL", un document PDF publié par AOL.
Cet article, déjà intéressant en soi est devenu un document de référence car l'auteur du document AOL est intervenu sur le site de l'ABUL et il s'en est suivi une discussion très instructive. Malgré le niveau technique des échanges, la lecture de cette discussion peut apporter à tous une meilleure compréhension du fonctionnement du courrier électronique.
La discussion centrée naturellement sur AOL parle des relations parfois tendues entre les différents FAI et permet de mieux comprendre les problèmes.
Beaucoup s'accordent à dire que Gentoo[1] est un excellent projet, car très bien documenté (évidemment ce n'est pas le seul argument, mais il y contribue fortement). Notamment, les documentations officielles[2] sont fournies, et expliquent l'installation de la distribution, ainsi que son fonctionnement global (Portage, ebuilds, options USE, etc.).
Un site non officiel[3] existe également, qui permet de naviguer dans l'arbre de Portage, de faire des recherches de dépendance inverses, et quelques petits trucs assez intéressants. Thrasher (l'administrateur de tout ça) a eu également la bonne idée de créer un wiki[4] qui permettrait de rassembler des documentations non officielles sur la configuration, le fonctionnements, des FAQ, des pages de manuel, des petites astuces, etc.
La désormais très connue encyclopédie en ligne Wikipedia a atteint, le lundi 20 septembre 2004, le seuil du million d'articles dans plus de 100 langues.
Avec une moyenne de 2500 nouveaux articles par jour dernièrement, Wikipedia est actuellement la plus vaste et la plus complète des encyclopédies.
L'année 2004 a été pour Wikipedia celle de toutes les "grandes nouvelles". En effet, on ne compte plus les seuils d'articles atteints dans différentes langues ces derniers temps, et l'encyclopédie s'est vue attribuer deux prix internationaux : le Prix Ars Electronica et le Webby Award de la meilleur communauté.
À noter que des versions statiques de l'encyclopédie sont actuellement en préparation pour CD, DVD ou téléchargement.
Comme annoncé précédemment, l'Encyclopédie Hachette Multimédia 2005 qui est sortie début de ce mois, est multi-plateforme windows, mac osX et linux (x86).
Bien que propriétaire, ce produit (édité par idm) apporte sur notre système un produit familial, grand public, et plutôt attrayant.
En effet, le "mode panorama" remplace avantageusement les listes de résultats, en construisant pour vous une "une" de magazine basé sur votre requête (je vous conseille les captures d'écrans ci-dessous).
NdM : au passage,
Wikipedia, l'encyclopédie libre et coopérative vient d'atteindre le million d'articles en ligne en 100 langues (dont 53000 en
français et 352000 en anglais)
Cette application peu connue trouvera certainement sa place dans la boîte à outils d'un développeur. Écrit en java, ce logiciel est sous licence GPL.
Il permet de s'affranchir du modèle d'écriture linéaire du papier en proposant de structurer les matières en arbre. Ce modèle a l'avantage d'offrir une vue d'ensemble instantanée du document et une compréhension plus intuitive de sa hiérarchie.
Très souple d'utilisation, les rubriques / idées sont copiées ou déplacées à la souris ou par les traditionnels raccourcis claviers, permettant de réorganiser le document de façon fluide et d'avoir un retour immédiat sur le résultat. Pour une meilleure lisibilité, les sous-branches peuvent être masquées. Elles peuvent aussi être importées ou exportées, favorisant un découpage en documents spécialisés.
Les arbres sont stockés en XML et peuvent être publiés grâce à une applet Java (voir l'exemple en lien ci-dessous). Pour l'impression ou plus de légèreté, un export au format HTML est aussi possible. Ce format est moins dynamique mais permet néanmoins de déployer ou masquer les sous branches.
Pour ne rien gâcher, cette application est très légère (moins de 500 Ko).
Le projet Metadistros est un projet permettant de créer soi même et simplement un Live-CD en partant de n'importe quelle distribution (a priori).
Ce projet est supporté par un groupe d'espagnols, et donc l'ensemble de la documentation a été rédigé dans cette langue jusque là.
Pour des raisons évidentes de diffusion du projet, qui me semble très intéressant (et déjà exploité par la Guadalinex pour son utilisation/installation), il mériterait plus qu'une simple diffusion dans les pays d'Amérique Latine et en Espagne.
Souvent, lorsque l'on code, on ne se souvient plus forcément des différentes fonctions de telle ou telle bibliothèque C, une autre fois c'est la liste des balises (X)HTML ainsi que leurs attributs.
Pour remédier à cela, la page
Quick Reference Cards propose un certain nombre de fichiers au format PDF faisant la plupart du temps entre 1 et 4 pages et permettant d'avoir l'essentiel en condensé.
On y trouve des cartes pour CSS, XML Path, XSL, C, C++ STL, Perl, PHP, MySQL, etc... Soit au total, environ une quarantaine de cartes de références.
NdM : les cartes sont diffusées selon différentes licences, dont certaines peuvent ne pas être libres selon les définitions de la documentation libre (le contenu est purement technique) ou du logiciel libre de la FSF. La licence de chaque carte est précisée dans son contenu.
Le webmestre est heureux de vous faire connaître son site Web prog.qt, ouvert depuis quelques mois, mais ayant subi récemment des modifications.
Ce site est dédié à la bibliothèque Qt. En effet, malgré les qualités évidentes de la bibliothèque, il existe peu de sites dédiés exclusivement à celle-ci et aucun en français. Le site propose de rassembler les documentations et didacticiels en français sur le sujet.
Un forum est également présent permettant aux développeurs de tous niveaux de s'exprimer et de s'entraider.
Le site est depuis peu référencé sur le site de Trolltech dans la rubrique Developer. Totalement indépendant de cette société, le site a pour vocation d'aider les personnes désirant débuter la programmation avec cette bibliothèque.
Le site Secuobs.com vous propose un tutorial de 6 pages sur l'implémentation et la sécurisation du serveur web apache pour Linux. L'utilité, l'installation et la configuration des composants suivants sont expliqués dans ce document : Apache avec DSO (Dynamic Shared Object), Openssl, Php4, Mysql, Mod_ssl, Mod_rewrite, Mod_perl, Mod_security avec Snort2modsec.pl et snortrules-snapshot-CURRENT.
Le tutorial se décompose en deux parties : une partie classique d'installation et de configuration manuelle à la manière des "how-to", et une partie automatisée qui vous permettra en récupérant l'unique script exoweb.pl d'installer et de configurer automatiquement l'ensemble de ces composants. A noter que chaque composant peut également être installé séparément et automatiquement via des mini-scripts shell en fonction de ceux que vous souhaitez installer ou de ceux que vous avez déjà installés.
Mise à jour importante du tutorial : intégration de la nouvelle version stable de mod_security 1.8 nouvellement sortie, activation du chroot par mod_security dans la configuration par défaut de la procédure automatisée, bugfixes de la procédure chroot manuelle et automatisée
Afin d'aider les Directions Informatiques à utiliser pleinement les solutions diffusées selon le modèle Open Source, IDEALX publie régulièrement, depuis plusieurs années, une nouvelle édition de son guide.
L'édition de juin 2004 comprend une introduction à l'opensource, une méthode de sélection-qualification de logiciel libre, un tableau synthétique de comparaison des logiciels, des conseils issus du terrain permettant d'aborder aisément l'opensource, une sélection de logiciels (incontournables et prometteurs), une présentation de solutions opensource développées par IDEALX et un exposé d'un mode de migration d'infrastructure.
Il concerne les décideurs (donc ceux qui souhaitent les convaincre...). Nous avons tenté de ne pas le noyer de grosse pub qui tache et de privilégier l'information utile donc objective.
Un mois après son retour à plein régime et un certain nombre de publications pour le seul mois de mai, le site Léa-Linux met aujourd'hui en ligne un format de document nouveau sur le site : les Fiches de Léa.
Elles sont destinées au grand débutant et répondent à des questions que se posent les nouveaux arrivants, et qui sont récurrentes sur les forums.
Ces fiches s'inscrivent dans un travail de fond engagé par l'équipe et des contributeurs fidèles visant à mettre à jour les articles les plus obsolètes, les rendre multi-distributions (le groupe slackware notamment est très actif et a déjà publié 3 mises à jour cette semaine). Bien évidemment, toute contribution nouvelle est la bienvenue (écrire à admin at lea-linux point org).
Une dépêche passée sur Linuxfr en 2003 faisait état d'une série de livres sous licence OPL (Open Publication License). Ces livres, qui sont édités par Prentice Hall, sont dans un premier temps commercialisés sous une forme traditionnelle puis sont disponibles quelques mois après leur sortie en téléchargement.
Sept livres ainsi que leurs sources sont actuellement disponibles:
- Implementing CIFS: The Common Internet File System
- Embedded Software Development with eCos
- Linux Development Platform
- Managing Linux Systems with Webmin: System Administration and Module Development
- Samba-3 HOWTO and Reference Guide
- System Intrusion Detection with SNORT
- Rapid Application Development with Mozilla
Nous venons de traduire le tutoriel de GnuArch, le système de contrôle de version.
Arch a, entre autres, la particularité de pouvoir être utilisé d'une manière totalement décentralisée (ou non). Il permet de travailler hors connexion (archiver, consulter l'historique etc.). Grâce à un système de cache optimisé, ce qui n'est pas étonnant lorsqu'on sait que l'auteur lui-même n'a pas de connexion "haut débit" !
Il a également la particularité d'être très "kiss" (Keep It Simple, Stupid). Le format d'archivage n'est qu'une suite de patchs, diffs, tgz déposés dans une arborescence. Ce qui fait qu'une archive peut être déposée sur un simple serveur de fichiers (local, ftp, http, webdav, ssh). Aucun serveur spécifique n'est donc nécessaire.
Nous avons effectué cette traduction pour mieux comprendre le fonctionnement de GnuArch, il se peut que des erreurs d'interprétations aient eu lieu, merci de nous les signaler (ainsi que toutes fautes simples et stupides !).